Release 10.1A: OpenEdge Deployment:
Managing 4GL Applications


Using the PROLIB utility

The PROLIB utility allows you to create and maintain standard libraries and generate memory-mapped libraries. This is the syntax to start the PROLIB utility:

Operating system

Syntax
UNIX
Windows
prolib library-name parameter [ file-name ... ]
[ parameter [ file-name ... ] ... ]

library-name

Specifies the name of an r-code library. The library name must have a .pl extension.

parameter

Specifies what action to take on the library. Table 6–1 lists the parameters and their descriptions.

Table 6–1: PROLIB utility parameters
Parameters
Description
-create 
Creates a new standard library.
-makeshared 
Generates a memory-mapped library from a standard library.
-add 
Adds files to a standard library.
-replace 
Replaces files in a standard library.
-delete 
Deletes files from a standard library.
-list 
Lists library information such as library name, format, code page, and file contents.
-extract 
Extracts files from a standard library. This parameter copies a file from the library into another file, outside of the library, and gives it the same name.
-yank 
Extracts files from a standard library and places them in the current working directory.
-compress 
Compresses a standard library by making a copy of it.
-nowarn 
Suppresses any warning message that might occur during the operation of the primary parameters. If you add a file to a standard library with the -add and -nowarn parameters, and the file already exists in the library, PROLIB replaces the file.
-pf 
Allows you to supply command-line arguments in a parameter file. You cannot use -pf in a parameter file.
-verbose 
Directs PROLIB to display processing information that is ordinarily suppressed.
-date 
Specifies the format of the date as it appears when you use the -list parameter.

When specifying a parameter, you do not have to type the complete parameter name. You can type the minimally unique string for each parameter (for example, -l for -list and -e for -extract).

The -nowarn and -verbose parameters modify the behavior of the -create, -makeshared, -add, -replace, -delete, -list, -extract, and -yank parameters.

You can place the -nowarn, -pf, and -verbose parameters anywhere on the command line. They affect the processing of all other specified parameters.

You must place the -create parameter before all other parameters. PROLIB processes parameters in left-to-right order as they appear on the command line. If an error occurs during the PROLIB command, PROLIB terminates. This behavior occurs so that options specified later in the command line, which might depend on the failed option, do not execute.

You cannot use the -add, -replace, -delete, -extract, -yank, or -compress parameters with a memory-mapped library (that is, when you specify a memory-mapped library in library-name).

file-name

Specifies the name of an r-code file, or a memory-mapped library file when using the -makeshared parameter.


Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095